home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmActivateProtocol.z
/
XmActivateProtocol
Wrap
Text File
|
1998-10-30
|
4KB
|
67 lines
XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll - A VendorShell function that activates a
protocol
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Protocols.h>
vvvvooooiiiidddd XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll(
WWWWiiiiddddggggeeeetttt sssshhhheeeellllllll,
AAAAttttoooommmm pppprrrrooooppppeeeerrrrttttyyyy,
AAAAttttoooommmm pppprrrroooottttooooccccoooollll);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll activates a protocol. It updates the
handlers and the _p_r_o_p_e_r_t_y if the _s_h_e_l_l is realized. It is
sometimes useful to allow a protocol's state information
(callback lists, and so on) to persist, even though the
client may choose to temporarily resign from the
interaction. This is supported by allowing a _p_r_o_t_o_c_o_l to be
in one of two states: active or inactive. If the _p_r_o_t_o_c_o_l is
active and the _s_h_e_l_l is realized, the _p_r_o_p_e_r_t_y contains the
_p_r_o_t_o_c_o_l AAAAttttoooommmm. If the _p_r_o_t_o_c_o_l is inactive, the AAAAttttoooommmm is not
present in the _p_r_o_p_e_r_t_y.
XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll is a convenience interface. It calls
XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollllwith the property value set to the atom
returned by interning WWWWMMMM____PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLLSSSS.
_s_h_e_l_l Specifies the widget with which the protocol
property is associated
_p_r_o_p_e_r_t_y Specifies the protocol property
_p_r_o_t_o_c_o_l Specifies the protocol AAAAttttoooommmm
For a complete definition of VendorShell and its associated
resources, see VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3).
RRRREEEELLLLAAAATTTTEEEEDDDD
VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3), XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll(3),
XXXXmmmmRRRReeeemmmmoooovvvveeeePPPPrrrroooottttooooccccoooollllssss(3) and XXXXmmmmIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm(3).
Page 1 (printed 10/24/98)